From f060a9866f4a1b6214ac8defd13cb875b9050630 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Mon, 14 Aug 2006 20:56:46 +0000 Subject: [PATCH] Add a warning about the semantics of gtk_recent_chooser_add_filter() and 2006-08-14 Emmanuele Bassi * gtk/tmpl/gtkrecentchoosermenu.sgml: Add a warning about the semantics of gtk_recent_chooser_add_filter() and of gtk_recent_chooser_remove_filter() when applied to a GtkRecentChooserMenu. --- docs/reference/ChangeLog | 7 +++++++ docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml | 12 ++++++++++++ 2 files changed, 19 insertions(+) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 531338e497..e90c765812 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,10 @@ +2006-08-14 Emmanuele Bassi + + * gtk/tmpl/gtkrecentchoosermenu.sgml: Add a warning about + the semantics of gtk_recent_chooser_add_filter() and of + gtk_recent_chooser_remove_filter() when applied to a + GtkRecentChooserMenu. + 2006-08-14 Matthias Clasen * gtk/tmpl/gtkruler.sgml: Fix a swapped argument diff --git a/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml b/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml index ba1659dd1b..79d515b18c 100644 --- a/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml +++ b/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml @@ -16,6 +16,18 @@ Note that #GtkRecentChooserMenu does not have any methods of its own. Instead, you should use the functions that work on a #GtkRecentChooser. + +Note also that #GtkRecentChooserMenu does not support multiple filters, as it +has no way to let the user choose between them as the #GtkRecentChooserWidget +and #GtkRecentChooserDialog widgets do. Thus using gtk_recent_chooser_add_filter() +on a #GtkRecentChooserMenu widget will yield the same effects as using +gtk_recent_chooser_set_filter(), replacing any currently set filter +with the supplied filter; gtk_recent_chooser_remove_filter() will remove +any currently set #GtkRecentFilter object and will unset the current filter; +gtk_recent_chooser_list_filters() will return a list containing a single +#GtkRecentFilter object. + + Recently used files are supported since GTK+ 2.10. -- 2.30.2